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Abstract 


ORA  is  software  for  the  analysis  of  network  structure.  The  ORA  components  are  a  collection  of 
programs  that  implement  the  features  available  in  ORA  as  of  the  vl.9.5.4.5  (August  2009) 
software  release. 
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ORA  Components 


The  ORA  components  are  a  collection  of  java  executable  programs  for  use  in 
Social  Network  Analysis  applications.  These  components  are  used  by 
interface  programs  such  as  ORA  GUI  and  SORASCS. 

The  components  described  in  this  manual  are  based  on  the  ORA  vl.9.5.4.5 
(August  2009)  software  release. 

How  To  Use 

The  components  require  Java  1.6  or  higher  and  are  callable  via  a  command 
line  interface.  The  following  example  shows  how  to  call  the  Lowercase 
routine. 

C:\>  java  -cp  ORA_CP  edu. emu. casos.Oralll. controller. OraMain 

ORA_CP  is  the  class  path  for  ORA  and  is  contained  in  Appendix  I,  from 
which  it  can  be  copied. 

edu. emu. casos.Oralll. controller. OraMain  is  the  name  of  the  routine  to 
run. 

The  ORA  components  are  not  directly  callable  from  a  Java  program  except  to 
the  extent  to  which  any  main()  may  be  called.  No  guarantee  is  given  to 
components  being  called  in  this  manner. 

File  Types 

The  file  types  used  are  industry  standard.  This  permits  maximum  flexibility 
in  using  the  AutoMap  components  with  other  components.  All  components 
assume  that  files  are  in  a  standard  UTF-8  file  encoding. 

•  Text  Files.  The  text  file  is  for  human-readable  text.  AutoMap 
components  assume  these  files  have  a  .txt  extension. 

•  CSV  Files.  The  comma  separated  values  file  is  for  information 
organized  in  a  table.  AutoMap  components  assume  these  files  have  a 
.csv  extension. 

•  XML  Files.  The  XML  file  is  used  for  structured  data,  such  as  DyNetML 
used  for  expressing  dynamic  networks.  AutoMap  components  assume 
these  files  have  a  .xml  extension. 
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Classifications 


The  components  are  classified  based  on  their  usage. 

•  File  Utility.  These  routines  are  provided  as  an  aid  in  manipulation  of 
files  to  prepare  them  for  processing. 

•  Internal  Command.  An  internal  command  is  a  routine  that  has  no 
obvious  interface  to  the  end  user. 

•  External  Tool.  An  external  tool  is  a  stand-alone  routine  with  its  own 
user  interface.  The  external  tool  is  available  to  aid  in  the  manipulation 
of  supplemental  files. 


Component  Reference 

This  section  gives  an  alphabetical  list  of  all  ORA  components.  This  list  may 
not  include  routines  that  are  used  by  the  ORA  components  indirectly  or 
routines  that  may  be  called  by  3rd  party  libraries  that  ORA  may  make  use  of. 

Mandatory  arguments  are  listed  in  <angle  brackets>  with  the  pipe  |  symbol 
being  used  to  identify  accepted  options.  Optional  arguments  are  in  [square 
brackets].  Ellipses  signify  that  an  option  may  be  repeated  many  times. 
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OraMain 


This  routine  will  launch  the  ORA  GUI  with  no  dataset.  There  are  no 
parameters. 

Classification:  External  Tool 

Input  File  Type:  N/A 

Output  File  Type:  N/A 

Usage: 

java  -cp  ORA_CP  edu. emu. casos.OraUI. controller. OraMain 

Parameters: 

None 


3 


OraMainLoadAndSelectedReports 


This  routine  will  launch  the  ORA  GUI  with  selected  datasets  and  with  only 
the  specified  reports  enabled.  If  no  datasets  are  specified,  then  none  are 
loaded.  If  no  reports  are  specified,  then  all  are  available.  Thus,  if  no 
command  line  arguments  are  provided,  then  this  routine  is  the  same  as  the 
OraMain  routine. 

Classification:  External  Tool 

Input  File  Type:  N/A 

Output  File  Type:  N/A 

Usage: 

java  -cp  ORA_CP 

edu.cmu.casos.OraUI.  controller.  OraMainLoadAndSelectedReports 
<dataset_filename>...  <report_ID>  ... 

Parameters: 

<dataset_filename>  Zero  or  more  filenames  of  datasets  to  automatically 

load  at  startup. 

<report_ID  >  Zero  or  more  reports  to  be  available  to  the  user  at 

startup.  If  none  are  specified,  then  all  reports  will  be 
available.  The  report  IDs  that  can  be  used  are  listed 
in  Appendix  II. 


4 


Appendix  I  -  ORA  ClassPath 


The  ORA  classpath  is  long:  it  is  printed  here  so  that  it  can  copied  and 
pasted: 

lib /or a . j  ar ; lib/ j freechart-1 . 0 . 13 . j  ar ; lib/ j freechart-1 .0.13- 

swt . j  ar; lib/ xerceslmpl . j  ar; lib/TableLayout . j  ar; lib/ j  common- 

1.0  .  9  .  j  ar;  lib/httpcore-nio-4 . 0-beta3 . j  ar; lib/ j  3dcore . j  ar; lib/httpcore-4 . 0- 

beta3 . j  ar ; lib/ j  ung . j  ar ; lib/ twitter 4 j - 

1 . 1 . 7 .  j  ar ; lib/ j  calendar . j  ar ; lib/rssutils . j  ar ; lib/ omj  3d . j  ar; lib/ j  son- 

1.0  .  j  ar;  lib/  commons -col lections -3 . 1 . j  ar; lib/ j  si -generics . j  ar; lib/ opencsv- 

1 . 7 .  j  ar ; lib/ trove-2 . 0 . 4 . j  ar ; lib/ xml-writer .jar; lib/ commons-logging-api- 

1.1.1. jar;lib/junit.jar;lib/jts-1.7- 

generics . j  ar ; lib/ caso sparser . j  ar ; lib/ j graph layout .jar; lib/htmlparser . j  ar ; lib/ 
facebook-util-1 . 8 -final . j  ar; lib/ j  3d-vrml97 . j  ar; lib/ omcorba . j  ar; lib/ ant- 
launcher . j  ar; lib/ colt . j  ar; lib/wwj /worldwind-ora . j  ar; lib/ freehep/ freehep- 
graphics2d-2 . 0 . j  ar; lib/gt2-2 . 3 . 3/ gt2 -widgets -swing- 2 . 3 . 3 . j  ar; lib/gt2- 
2.3. 3/batik-svggen-l . 6 . j  ar; lib/gt2-2 . 3 . 3/ spatialdb-0 .l.jar;lib/gt2- 
2 . 3 . 3/velocity-l . 4 . j  ar; lib/gt2-2 . 3 . 3/gt2-go-2 . 3 . 3 . j  ar; lib/gt2-2 . 3 . 3/ j  srl08- 
0 . 01 . j  ar ; lib/gt2 -2 . 3 . 3/db2 j  cc__dummy-8 . 2 . 1 . j  ar ; lib/gt2-2 . 3 . 3/gt2-postgis- 

2 . 3 . 3 .  j ar ; lib/gt2 -2 . 3 . 3/gt2-xml-gml3-2 . 3 . 3 . j ar; lib/gt2-2 . 3 . 3/gt2-xml- 

2.3.3. jar;lib/gt2-2.3.3/ concurrent- 1 .3.4.jar;lib/gt2-2.3.3/ gt2-image- 

2.3.3. jar;lib/gt2-2.3.3/j  axb-impl-1 . 3 . j  ar ; lib/gt2-2 . 3 . 3/gt2-tiger- 

2.3.3. jar;lib/gt2-2.3.3/ imageioext-asciigrid-1 . 0-rcl . jar; lib/gt2-2 . 3 . 3/gt2- 
api-2.3.3.jar;lib/gt2-2.3.3/ gt 2 -shape file -2 . 3 . 3 . j  ar; lib/gt2-2 . 3 . 3/ gt 2 -main- 

2.3. 3.  jar;  lib /gt  2-2. 3. 3/  gt 2 -validation- 2 ,3.3.jar;lib/gt2-2.3.3/ commons - 
j  xpath-1 .2 . j  ar ; lib/ freehep/ f reehep-graphicsio-svg-2 . 0 . j  ar ; lib/gt2- 
2.3.3/ecore-2.1.0.jar;lib/gt2-2.3. 3/postgis-driver-l . 0 . j  ar ; lib/gt2- 

2.3.3/ commons -beanutils-1 . 4 . j  ar ; lib/gt2-2 . 3 . 3/ relaxngDatatype-X . j  ar ; lib/gt2- 
2.3. 3/gt2-db2-2 . 3 . 3 . j ar; lib/gt2-2 . 3 . 3/geowidgets-l . 0- 
M1 .jar; lib/ j ai  codec .jar; lib/ freehep/ freehep-graphicsio- 
2 . 0 . j  ar; lib/ j  ogl/ j  ogl . j  ar; lib/ freehep/ freehep- io- 

2 . 0 . 1 . j  ar ; lib/ freehep/ freehep -xml -2 . 0 . 1 . j  ar; lib/gt2-2 . 3 . 3/ ant-optional- 

1.5.1.  jar; lib/gt2-2 . 3 . 3/gt2-vpf-2 .3.3. jar; lib/gt2-2 . 3 . 3/gt2-demo-property- 

2 . 3 . 3 .  j  ar ; lib/gt2-2 . 3 . 3/ commons -pool -1 .3.jar;lib/gt2-2.3.3/j  dom- 

1 . 0 . j ar ; lib/gt2 -2 . 3 . 3/gt2-cql-2 . 3 . 3 . j ar ; lib/gt2-2 . 3 . 3 /geoapi -nogenerics -2 . 1- 
M2 . jar; lib/gt2-2 . 3 . 3/gt2-sde-dummy-2 .3.3. jar; lib/gt2-2 . 3 . 3/vecmath- 

1 . 3 . 1 .  jar; lib/gt2-2 . 3 . 3/velocity-dep-l . 4 . j ar; lib/gt2-2 . 3 . 3 /gt 2 -cover age - 

2 . 3 . 3 .  j ar ; lib/gt2 -2 . 3 . 3 /batik-util- 1 . 6 . j ar; lib/gt2-2 . 3 . 3/gt2-wms- 

2.3.3. jar;lib/gt2-2.3.3/j  axb-api-1 . 3 . j  ar ; lib/ omsvg . j  ar ; lib/gt2-2 . 3 . 3 /batik- 
xml- 1  . 6 . j  ar ; lib/gt2-2 . 3 . 3/batik-bridge-l . 6 . j  ar ; lib/gt2-2 . 3 . 3/ commons -lang- 

2.1. jar;lib/gt2-2.3.3/ gt 2 -render- 2 . 3 . 3 . j  ar; lib/gt2-2 . 3 . 3/batik-dom- 

1.6. jar;lib/gt2-2.3.3/ gt 2 -graph- 2 ,3.3.jar;lib/gt2-2.3.3/ commons -logging- 

1 . 0 . 4 . j ar; lib/gt2-2 . 3 . 3/gt2-epsg-hsql-2 . 3 . 3 . j ar; lib/gt2-2 . 3 . 3/gt2-indexed- 
shapef ile-2 . 3 . 3 . j  ar ; lib/gt2-2 . 3 . 3/ j lfgr-1 . 0 . j  ar ; lib/gt2-2 . 3 . 3/gt2-hsql- 

2 . 3 . 3 .  j  ar ; lib/ j  ava-getopt-1 . 0 . 13 . j  ar; lib/gt2-2 . 3 . 3/batik-svg-dom- 

1.6. jar;lib/gt2-2.3.3/ common- 2 . 1 . 0 . j  ar ; lib/gt2-2 . 3 . 3/gt2-geotif f- 

2 . 3 . 3 .  j ar; lib/toolkits  1-2- 

0 . j  ar ; lib/milStd2  52  5  png . j  ar ; lib/ j  3dutils . j  ar ; lib/gt2 -2 . 3 . 3/ commons -logging- 
1 . 0 . j  ar ; lib/ JAXWS2 .1.3-20071218. jar; lib/ Jama-1 . 0 . 1 . j  ar ; lib/ commons-codec- 

1.3.  jar; lib/gt2-2 . 3 . 3/gt2-imagemosaic-2 .3.3. jar; lib/ iText- 

2 . 1 . 0 . j  ar ; lib/ commons -math- 1 . 2 . j  ar; lib/gt2-2 . 3 . 3/postgresql-8 . 1- 
407 . jdbc3 . jar; lib/ freehep/ f reehep-util-2 .0.1. jar; lib/ idw- 


5 


1.5.0/ idw . j  ar ; lib/gt2-2 . 3 . 3/batik-awt-util-l . 6 . j  ar ; lib/gt2-2 . 3 . 3/ gt2-gtopo30 

2 . 3 . 3 .  j ar ; lib/gt2 -2 . 3 . 3/gt2-wfs-2 . 3 . 3 . j ar; lib/gt2-2 . 3 . 3 /pi cocontainer- 

1.2.  jar; lib /gt 2-2. 3. 3/ gt2-arcgrid-2 ,3.3.jar;lib/gt2-2.3.3/ gt2-mysql- 

2 . 3 . 3 .  j ar ; lib/gt2 -2 . 3 . 3/gt2-openoff ice-2 . 3 . 3 . j ar; lib/gt2-2 . 3 . 3 /batik- ext - 

1.6. jar;lib/gt2-2.3.3/ gt 2 -oracle -spatial -2 . 3 . 3 . j  ar ; lib/gt2-2 . 3 . 3/batik-gvt- 

1 . 6 .  j  ar ; lib/gt2 -2 . 3 . 3/gt2-svgsupport-2 ,3.3.jar;lib/gt2-2.3.3/ commons - 
collections-2.0.jar;lib/ svgSalamander-tiny . j  ar ; lib/ j  hall . j  ar ; lib/gt2- 
2.3. 3 /batik-css- 1 . 6 . j  ar; lib/gt2-2 . 3 . 3/ gt2-mappane-2 . 3 . 3 . j  ar; lib/gt2- 
2.3. 3/gt2-demo-mappane-2 .3.3. jar; lib/gt2-2 . 3 . 3/gt2-directory- 

2.3.3.  jar; lib/gt2-2 . 3 . 3/gt2-geomedia- 

2 . 3 . 3 .  j  ar ; lib/ activation . j  ar; lib/ commons -logging-1 . 1 . 1 . j  ar; lib/gt2-2 . 3 . 3/gt2 
mif-2 . 3 . 3 . j  ar ; lib/ openmap . j  ar; lib/gt2-2 . 3 . 3/ gt2-xml-f ilter- 

2 . 3 . 3 . j  ar ; lib/httpmime-4 . 0-beta2 . j  ar ; lib/gt2-2 . 3 . 3/ j unit- 
3 . 8 . 1 . j  ar ; lib/ j  ai  core.jar;lib/gt2-2.3.3/ xml-apis- 

1 . 0 . b2 . j  ar ; lib /mail . j  ar ; lib/gt2 -2 . 3 . 3/hsqldb-l . 8 . 0 . 1 . j  ar ; lib/ j  ogl/ gluegen- 
rt . j  ar ; lib/gt2 -2 . 3 . 3/ commons -cl i -2 . 0-gt2-prel . j  ar ; lib/gt2-2 . 3 . 3/ commons -io- 

1 . 2 .  j  ar ; lib/gt2-2 . 3 . 3/xsd-2 . 1 . 1 . j  ar ; lib/gt2-2 . 3 . 3/ gt2-demo-data- 

2 . 3 . 3 . j  ar ; lib/gt2 -2 . 3 . 3/batik-transcoder-l . 6 . j  ar ; lib/ j  avaml- 
0.0.12.jar;lib/gt2-2.3. 3/gt2-epsg-access-2 ,3.3.jar;lib/gt2-2.3.3/jta- 
1.0.1B.jar;lib/gt2-2.3. 3/gt2-epsg-postgresql-2 ,3.3.jar;lib/gt2-2.3.3/gt2- 
referencing-2 . 3 . 3 . j  ar ; lib/ freehep/ f reehep-graphicsio-pdf-2 . 0 . j  ar; lib/gt2- 
2 . 3 . 3/gt2 -brewer- 2 . 3 . 3 . j  ar ; lib/gt2-2 . 3 . 3/ xercesImpl-2 . 7 . 1 . j  ar ; lib/ commons - 
httpclient-3 . 1 . j  ar; lib/gt2-2 . 3 . 3/ image ioext-customst reams -1 . 0- 

rcl . j  ar ; lib/gt2-2 . 3 . 3/ j dbc-stdext-2 . 0 . j  ar ; lib/httpclient-4 . 0- 
beta2 . j  ar ;  lib/gt2 -2 . 3 . 3/ j  dom-b9 . j  ar ; lib/gt2-2 . 3 . 3/ j axb-libs-1 . 3 . j  ar ; lib/gt2- 
2.3.3/ gt2 -imagepyramid-2 . 3 . 3 . j  ar ; lib/gt2-2 . 3 . 3/batik-script-l . 6 . j  ar ; lib/gt2- 
2. 3. 3/xsdlib -20050614. jar; lib/ facebook- j  ava-api-1 . 8 -final . j  ar; lib/gt2- 
2.3. 3/gt2-arcsde-2 . 3 . 3 . j ar; lib/gt2-2 . 3 . 3/gt2-coveragetools- 

2 . 3 . 3 . j  ar ; lib /MDate Select or 14 -0034  7 . j  ar ; lib/ rome-1 .0.jar;lib/gt2-2.3.3/gt2- 
shapef ile-renderer-2 . 3 . 3 . j  ar; lib/gt2-2 . 3 . 3/ gt2-epsg-wkt-2 ,3.3.jar;lib/gt2- 
2 . 3 . 3/gt2 -gml-2 . 3 . 3 . j  ar ; lib/gt2-2 . 3 . 3/log4 j -1 . 2 . 6 . j  ar ; lib/gt2-2 . 3 . 3/ xml -apis 
xerces-2 . 7 . 1 . j  ar; lib/gt2-2 . 3 . 3/batik-parser-l . 6 . j  ar ; lib/gt2-2 . 3 . 3/ gt2-xml- 
gml2 -2 . 3 . 3 . j  ar ; lib/gt2-2 . 3 . 3/ gt2-referencing3D-2 . 3 . 3 . j  ar ; lib/ j  dom. j  ar 
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Appendix  II  -  Report  IDs 


Below  are  listed  the  report  IDs  that  uniquely  identify  the  reports  in  ORA.  They  are  used  as  input 
parameters  to  various  routines. 


Report  ID 

Report  Title  (used  in 
GUI) 

Description 

riskCategories 

All  Measures 

Computes  a  collection  of  measures  and 
generates  output  in  categories.  Each 
category  analyzes  a  particular  aspect  of 
the  meta-network  structure. 

beliefPropagation 

Belief  Propagation 

Estimates  belief  propagation  through 
social  networks 

cpof 

CPOF 

Analyzes  the  creation  and  modification 
of  events  and  tasks  and  agent 
collaboration  over  time. 

capabilities 

Capabilities 

Analyzes  the  knowledge,  resource,  and 
task  capabilities  of  agents  and 
organizations  in  the  network. 

keyChange 

Change  in  Key 

Entities 

Analyzes  the  changes  over  time  of  the 
agents  that  score  highest  in  measure 
values. 

communicationAssessment 

Communications 
Network  Assessment 

This  report  assesses  a  communications 
network.  As  information  on  speed  of 
information  transmittal  becomes 
available  it  will  be  updated.  This  report 
takes  a  resource  by  resource  network 
(preferably  one  where  the  nodes  are 
communications  devices  and  the  links 
are  the  speed  or  reliability  of  the  link). 

communicativePower 

Communicative 

Power 

Analyzes  one  or  more  semantic 
networks  to  classify  concepts  by 
measure  values. 

communicators 

Communicators 

Analyzes  the  communication  network 
(agent  by  agent)  and  gives  high  level 
statistics  on  its  structure. 

context 

Context 

Compares  measured  values  against 
various  stylized  forms  of  networks  in  an 
effort  to  characterize  network  topology. 

coreNetwork 

Core  Network 

Computes  the  core  network  and  reports 
general  statistics. 

criticalSets 

Critical  Sets 

Finds  critical  sets  of  nodes  in  a  network 
that  best  reach  all  other  nodes,  or  whose 
removal  maximally  disrupts  a  network. 

custom 

Custom 

Computes  a  custom  report  with  user 
selected  measures  and  output  tables, 
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pictures,  and  figures. 

drillDown 

Drill  Down 

Computes  the  drill  down  from  a 
selected  organization  and  then  to  a 
selected  agent. 

geospatialAssessment 

Geospatial 

Assessment 

Linds  nodes  that  are  co-located  based, 
and  counts  the  number  of  nodes  that 
appear  at  location  pairs. 

groupTalk 

Group  Talk 

Analyzes  the  relationship  between 
agents  and  knowledge. 

content  Analysis 

Hot  Topics  (Content 
Analysis) 

Analyzes  semantic  network  output  from 
AutoMap. 

immediatelmpact 

Immediate  Impact 

Computes  the  key  actors  of  the  network, 
and  then  isolates  them  individually  to 
determine  the  effect  on  measure  values. 

influenceNetwork 

Influence  Net 

Displays  the  influence  network  and 
gives  high  level  statistics  on  its 
structure. 

intelligence 

Key  Entity 

Identifies  key  entities  and  groups  who 
by  virtue  of  their  position  in  the  network 
are  critical  to  its  operation. 

list 

Large  Scale 

Computes  all  network  analysis 
measures. 

localPattems 

Local  Patterns 

Lind  link  patterns  in  a  network,  such  as 
Star,  Checkerboard,  and  Clique. 

subGroup 

Locate  SubGroups 

Identifies  the  subgroups  present  in  the 
network  using  various  grouping 
algorithms. 

management 

Management 

Identifies  over-  and  under-performing 
individuals  and  assesses  the  state  of  the 
network  as  a  functioning  organization. 

merchantMarine  V  e  s  sel 

Merchant  Marine 

Analyzes  the  relationships  between 
crew  members,  owners,  vessels  and 
locations  of  the  Merchant  Marine 

Vessel  data. 

missingLinks 

Missing  Links 

Compute  possible  missing  links  in  a 
network. 

optimizer 

Optimizer 

Adapt  the  link  structure  of  a  meta¬ 
network  to  maximize  or  minimize 
selected  measure  values. 

partOfSpeech 

Part  Of  Speech 

Describe  the  distribution  of  concepts  by 
part  of  speech  in  one  or  more  networks. 

potentialErrors 

Potential  Errors 

Detects  potential  errors  in  agent  to  agent 
interactions  based  on  the  expected 
interactions  from  cognitive  similarity 
and  expertise. 

health 

Public  Health 

Analyzes  health  department  data  to  find 
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potential  problems. 

qap 

QAP/MRQAP 

Analysis 

Computes  QAP  and  MRQAP 

Correlation  and  Regression  (Dekker  and 
Y-Permutation  methods)  on  input 
networks. 

semanticNetwork 

Semantic  Network 

Analyzes  one  or  more  semantic 
networks,  computing  the  central 
networks  and  key  concepts  and  links. 

shortestPath 

Shortest  Path 

Computes  the  shortest  path  between  two 
entities  and  general  statistics  on  the 
paths.  The  sphere  of  influence  of  each 
entity  is  also  computed. 

simmelianTies 

Simmelian  Ties 
Analysis 

Calculates  the  number  of  Asymmetric, 
Sole- Symmetric,  and  Simmelian  ties  in 
unimodal  networks  computes  standard 
measures  on  them. 

egoNetwork 

Sphere  of  Influence 

For  each  individual,  identifies  the  set  of 
actors,  groups,  knowledge,  resources, 
etc.  that  influence  and  are  influenced  by 
that  actor. 

sna 

Standard  Network 
Analysis 

Calculates  the  standard  network 
analysis  measures  (degree  centrality, 
betweenness  centrality,  etc). 

statisticalNetworkMonitorin 

g 

Statistical  Change 
Detection 

Analyzes  the  changes  in  network-level 
measures  over  time  using  a  Statistical 
Process  Monitoring  (SPM)  control 
chart.  Control  limits  are  determined 
based  on  a  user  defined  level  of  risk. 

statisticalDistribution 

Statistical  Distribution 

Fits  statistical  distributions  to  a  network 
based  on  measure  values. 

tavi 

TAVI 

This  report  analyzes  the  Rendezvous 
and  Threat  event  data  from  the  TAVI 
project. 

tacticallnsight 

Tactical  Insight 

Analyzes  the  top  agent  nodes  across 
time  periods,  tracking  locations  and 
measure  values. 

trails 

Trails 

Analyzes  the  trails  that  an  entity  class 
makes  through  another  entity  class,  for 
example,  how  vessels  pass  through 
ports. 

uniqueTrails 

Unique  Trails  Report 

Analyzes  the  path  of  an  entity  class 
through  locations  over  time. 
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